home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glutessbeginpolygon.z / glutessbeginpolygon
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn - delimit a polygon description
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn( GLUtesselator* _t_e_s_s,
  14.                                GLvoid* _d_a_t_a )
  15.  
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _t_e_s_s  Specifies the tessellation object (created with gggglllluuuuNNNNeeeewwwwTTTTeeeessssssss).
  19.  
  20.      _d_a_t_a  Specifies a pointer to user polygon data.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn and gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn delimit the definition of a
  24.      convex, concave or self-intersecting polygon. Within each
  25.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn/gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn pair, there must be one or more
  26.      calls to gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr/gggglllluuuuTTTTeeeessssssssEEEEnnnnddddCCCCoooonnnnttttoooouuuurrrr. Within each contour,
  27.      there are zero or more calls to gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx. The vertices specify a
  28.      closed contour (the last vertex of each contour is automatically linked
  29.      to the first). See the gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx, gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr, and
  30.      gggglllluuuuTTTTeeeessssssssEEEEnnnnddddCCCCoooonnnnttttoooouuuurrrr reference pages for more details.
  31.  
  32.      _d_a_t_a is a pointer to a user-defined data structure. If the appropriate
  33.      callback(s) are specified (see gggglllluuuuTTTTeeeessssssssCCCCaaaallllllllbbbbaaaacccckkkk), then this pointer is
  34.      returned to the callback function(s). Thus, it is a convenient way to
  35.      store per-polygon information.
  36.  
  37.      Once gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn is called, the polygon is tessellated, and the
  38.      resulting triangles are described through callbacks.  See gggglllluuuuTTTTeeeessssssssCCCCaaaallllllllbbbbaaaacccckkkk
  39.      for descriptions of the callback functions.
  40.  
  41. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  42.      A quadrilateral with a triangular hole in it can be described as follows:
  43.  
  44.  
  45.           gluTessBeginPolygon(tobj, NULL);
  46.            gluTessBeginContour(tobj);
  47.              gluTessVertex(tobj, v1, v1);
  48.              gluTessVertex(tobj, v2, v2);
  49.              gluTessVertex(tobj, v3, v3);
  50.              gluTessVertex(tobj, v4, v4);
  51.            gluTessEndContour(tobj);
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.            gluTessBeginContour(tobj);
  75.              gluTessVertex(tobj, v5, v5);
  76.              gluTessVertex(tobj, v6, v6);
  77.              gluTessVertex(tobj, v7, v7);
  78.            gluTessEndContour(tobj);
  79.           gluTessEndPolygon(tobj);
  80.  
  81.  
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      gggglllluuuuNNNNeeeewwwwTTTTeeeessssssss, gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr, gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx, gggglllluuuuTTTTeeeessssssssCCCCaaaallllllllbbbbaaaacccckkkk,
  85.      gggglllluuuuTTTTeeeessssssssPPPPrrrrooooppppeeeerrrrttttyyyy, gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll, gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.